DEVICE DATASTORE

The DATASTORE device, is used to manage the reads and writesof the removable memory MMC (Multi Media Card) and in the non-removable memory (NAND) of the Qmove family instruments.

In the configuration unit, the BUS section must be declared so that you have the hardware resources required for the implementation of the DATASTORE device.

;---------------------------------
; Internal device declaration
;---------------------------------
INTDEVICE
<device name>    DATASTORE          TCamp          <port_type>

where:

;--------------------------------
; Internal device declaration
;--------------------------------
INTDEVICE
DEV        DATASTORE        0001        0

The access to MMC storage device, it is implemented through a “file_system” and not with direct access. In this way the saved data can be shared with any PC and the device is seen by it as a simple floppy disk.

File system features The file system supports the following types of FAT:
FAT12 Used on floppy disks or storage devices with limited capacity.
FAT16 Used in most storage devices. It can get to store 2 GB of data.
FAT32 Used in high-capacity storage devices, over 2 GB.

The file-system implemented, allows access to the file for reading and writing. Does not allow you to create directories, and then those files must be present in the single “root directory” . The device is also able to open/create files whose names or ASCII conversion of a number and the extension is fixed.

Supports two types of files:

• BINARY format: the file is written directly as if it were an array of long (“.hex” extension);
• CSV format (Comma Separated Values): data is written to a table with a number of columns can be set. The data are separated by “;” or is on a maximum number of characters for any data (fixed number).

Supported file formats are the BINART and the CSV. In our implementation are available the reading and appending functions (writing to END file), but not overwrite function on all types of files.

BINARY format The binary files have “hex” extension. In our implementation you can write and read a binary file where data values are stored in long (32bits) in hexadecimal base (HEX). To write or read such a file you must set the parameter filetype = 0.

Se abbiamo nelle variabili olongXX i valori:

olong01 = 0 => H’00000000
olong02 = -1 => H’FFFFFFFF
olong03 = 10000 => H’00002710
olong04 = -10000 => H’FFFFD8F0

Eseguiamo il comando WRITE impostando il parametro “field = 4”, otteniamo in coda al file:

00000000FFFFFFFF00002710FFFFD8F0''

Formato CSV I files csv avranno estensione “csv”. I dati scritti in questi file sono disposti in una tabella formata da un numero impostabile di colonne, ogni colonna viene detta “field”. Le righe della tabella sono dette “record”. Il device DATASTORE non considera la presenza dell'intestazione dei record. Il numero massimo di field è fissato a 32 (ilong / olong).

Per scrivere alcuni dati long tipo, “10000”, “-1”, “2147483647” e “-2147483648”, impostando il parametro “filetype = 1”,avremo:
Il file system supporta le seguenti tipologie di FAT:

Field1------------ +Field2--------- +Field3-------- +Field4-----+
10000              -1               2147483647      –2000000000

In questo modo l’occupazione di spazio di ogni record è fissa. Se impostiamo invece “filetype = 3”, avremo:

10000;-1;2147483647;–2000000000

I maggiori software d'elaborazione tra cui Microsoft Excel, OpenOffice Draw, Lotus 123, leggono con successo il file a larghezza fissa (filetype = 1) ma in fase di salvataggio lo trasformano in file con i delimitatori di campo (filetype = 3).
La differenza sostanziale tra un formato e l’altro sta nella ricerca dei records.
Leggere un determinato record con il formato 1, non è difficile in quanto la posizione d’inizio all’interno del file è calcolabile facilmente dato che la lunghezza del record è fissa.
Leggere invece un record con il formato 2, implica invece una ricerca all’interno del file della posizione d’inizio del record. Quest’operazione potrebbe risultare lunga.

Per utilizzare il dispositivo di memorizzazione (MMC) è necessario utilizzare il comando del device che permette di riconoscerlo e di attivarlo. Il comando MOUNT permette di eseguire quest'operazione. Il dispositivo sarà attivato quando lo stato st_mount assume il valore 1.
Si ricorda che dopo ogni comando il device segna che è in corso la gestione di tale comando con lo stato st_busy. Quando lo stato st_busy è a 1 il device non può accedere ad altri comandi.
Per aprire un file esistente o aprire un file nuovo bisogna impostare prima di tutto il parametro filetype. Esso permette di specificare il formato del file che s'intende trattare.
Di seguito divideremo la trattazione a seconda se il parametro filetype assume i seguenti valori:
a) 0: file binari;
b) 1-2: file CSV con spazio fisso per i dati;
c) 3-4: file CSV con i dati separati dal carattere “;”.
Prima di inviare il comando d'apertura del file bisogna specificare anche quale file s'intende aprire con il parametro filenuum.
Se il file e presente nel dispositivo di memorizzazione esso è aperto altrimenti viene creato un nuovo file con il nome specificato in file filenum.
Quando lo stato st_openfile è a 1 il file è aperto.

a) Nei file binari i dati sono presenti uno di seguito all'altro. È possibile:

• aggiungere un dato in coda;
• sovrascrivere un dato già presente nell'elenco (conoscendone la posizione).

Per leggere uno o più dati in un file binario, è necessario impostare nel parametro record da quale dato iniziare la lettura e nel parametro filed quanti dati leggere un massimo di 32 dati con una lettura. A questo punto si deve utilizzare il comando READ.
I dati letti sono riportati nei parametri ilong01÷ ilong32.

Lettura di 3 dati nella posizione 11, 12, 13 nel file binario.

DEV:record=11
DEV:field=3
READ DEV
WAIT NOT DEV: st_busy
glVar1=DEV: ilong01
glVar2=DEV: ilong02
glVar3=DEV: ilong03

Per scrivere uno o più dati in un file binario è necessario impostare nel parametro record da quale dato iniziare la sovrasrittura e nel parametro field quanti dati sovrascrivere.
I valori dei dati da sovrascrivere ai dati presenti nel file devono essere inseriti nei parametri olong01÷ olong32.

Scrittura di 3 dati nella posizione 11, 12, 13 nel file binario.

DEV:record=11
DEV:field=3
DEV:olong01=123        ;primo dato
DEV:olong02=456        ;secondo dato
DEV:olong03=789        ;terzo dato
WRITE DEV
WAIT NOT DEV: st_busy

Per accodare dei dati nuovi ad un file binario bisogna utilizzare il metodo descritto in precedenza ricordandosi di impostare il parametro record a -1.

B) Nei file CSV con spazio dati fisso, viene creata una tabella composta da colonne, chiamate field, e righe, chiamate record. Il numero di field con cui creare la tabella si deve specificare prima di aprire il nuovo file nel parametro field.
Per ogni dato inserito in questa tabella viene riservato uno spazio fisso. In questo modo ogni record, composto da un numero field di dati occupa uno spazio fisso nel file.
Per leggere un record di un file di questo tipo bisogna impostare nel parametro record il numero del record da leggere ed inviare il comando READ. Nei parametri ilong01-ilong32 vengono riportati i valori letti dal record.

Per sovrascrivere un record di un file di questo tipo bisogna impostare nel parametro record il numero del record da scrivere, impostare nei parametri olong01-olong32 un numero di valori pari al numero di field presenti nel record e quindi inviare il comando WRITE.
Per accodare un nuovo record al file è necessario impostare il valore -1 in record.

Lettura del record 3 (Composto di tre field):

DEV:record = 3
READ DEV
glVar1 = DEV:ilong01
glVar2 = DEV:ilong02
glVar3 = DEV:ilong03

C) Come nel caso B, ma in questo caso non è possibile leggere o sovrascrivere un particolare record. E' possibile solo leggere in modo sequenziale tutto il file e scrivere solo aggiungendo un nuovo record.

Tabella riassuntiva:

* = READ record sequenziali: lettura dei record presenti nel file partendo dal primo record fino all'ultimo. Questo tipo di lettura non prevede la possibilità di leggere record in ordine casuale all'interno del file. Questo tipo di lettura prevede solo di leggere i record partendo dal primo e leggendo sempre il successivo all'ultimo letto
* * = READ record indicizzati: questo tipo di lettura permette di leggere qualsiasi record presente nel file anche in ordine casuale.

Il nome del parametro, stato o comando è riportato alla sinistra della tabella.

R
Indica se il relativo parametro o stato è ritentivo (al momento dell’inizializzazione del device mantiene lo stato precedentemente definito), oppure lo stato che assume al momento dell’inizializzazione del device.
Se il device non necessita d'inizializzazione il campo “R” indica il valore che il parametro o stato assume all’accensione della scheda.
R = Ritentivo
0 = Al momento dell’inizializzazione del device il valore è forzato a zero.
1 = Al momento dell’inizializzazione del device il valore è forzato a uno.
- = Al momento dell’inizializzazione del device è presentato il valore significativo.

D
Indica la dimensione del parametro.
F = Flag
B = Byte
W = Word
L = Long
S = Single Float

Sono descritte tutte le condizioni necessarie affinché il parametro sia considerato corretto o perché il comando sia accettato.
In alcuni casi sono specificati dei valori limite per l’accettazione del parametro: se sono introdotti dei valori esterni ai limiti impostati, il dato è in ogni caso accettato; pertanto devono essere previsti opportuni controlli dell’applicativo tali da garantire il corretto funzionamento.
Per l’esecuzione di un comando, tutte le relative condizioni devono necessariamente essere soddisfatte; in caso contrario il comando non è inviato.

A
Indica il modo d'accesso.
R = Read (lettura).
W = Write (scrittura).
RW,= Read / Write.

Di seguito sono presentati i parametri, variabili, stati e comandi necessari all’esecuzione del device.

I dati tipo SINGLE non sono trattati. È necessario convertire questi dati di tipo interno prima di trasferirli nella MMC.

WAIT NOT DEV:st_busy               ; necessaria perché il device alla momento del RUN
                                   ; è in uno stato di busy finchè non termina
                                   ; le operazioni di inizializzazione.
MOUNT DEV                          ; esegue il MOUNT del dispositivo
WAIT NOT DEV:st_busy               ; attende il termine dell’operazione
IF DEV:st_mount                    ; se il dispositivo è presente,
  <operazioni>                     ;lo stato st_mount è 1
ENDIF

DEV:filetype = 0                   ; imposta il tipo di file BINARY
DEV:filenum = 123                  ; imposta il nome del file come “123.hex”
WAIT NOT DEV:st_busy
OPENFILE DEV                       ; esegui il comando di apertura
WAIT NOT DEV:st_busy               ; attende il termine dell’operazione
IF DEV:st_openfile                 ; se il file viene aperto correttamente,
  <operazioni>                     ;lo stato st_openfile è 1
ENDIF

DEV:field = 2                      ; imposta il numero di campi di cui
                                   ; è composto il record
                                   ; Nota: se il tipo di file è BINARY,
                                   ; questo parametro indica il numero di long
                                   ; che verranno scritte/lette.
DEV:record = -1                    ; indica al device di eseguire l’operazione a
                                   ; partire dalla fine del file (accodamento).
DEV:olong01 = 123456               ; imposta il dato da scrivere
DEV:olong02 = 654321
WAIT NOT DEV:st_busy
WRITE DEV                          ; esegui il comando di scrittura
WAIT NOT DEV:st_busy               ; attende il termine dell’operazione
IF DEV:st_error                    ; verifica se ci sono stati errori in scrittura
  <errore>
ENDIF